Skip to content

docs: no em dashes in the docs or the report strings - #21

Merged
TMHSDigital merged 1 commit into
mainfrom
docs/no-em-dashes
Sep 22, 2026
Merged

TMHSDigital merged 1 commit into
mainfrom
docs/no-em-dashes

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

Replaces the 34 em dashes left in tracked markdown and src/, and adds a CI job so they do not come back.

Replaced (34):

  • src/plumbline/report/markdown.py: 18. All of them were the report's bullet separator, - **Label** — text, which becomes - **Label**: text. This changes report text, not any number. No test pinned the old separator.
  • docs/example-report.md: 5. These are the same bullets. I changed them to match what the code now emits rather than regenerating the file, because the latency line differs on every run. The build still checks the ECE and accuracy lines against a fresh run, and it passes.
  • docs/PLAN.md: 7. datasets/public/README.md: 3 (our file, not the vendored one). CHANGELOG.md: 1. Each one was rewritten with a colon, parentheses, or a comma, whichever the sentence needed.

Untouched: datasets/public/jevbench-hard.jsonl (60 em dashes in the vendored MIT rows) and LICENSE-jevbench.

CI: a new prose job in ci.yml runs git grep -P '\x{2014}' -- '*.md' 'src/' ':!datasets/public/' and fails if it finds anything. I tested it locally both ways: it passes on this tree and catches a dash I injected.

Local: ruff, format, mypy, the full pytest suite, and build_site.py all pass.

🤖 Generated with Claude Code

…n new ones

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@TMHSDigital
TMHSDigital merged commit 5378730 into main Sep 22, 2026
14 checks passed
@TMHSDigital
TMHSDigital deleted the docs/no-em-dashes branch September 22, 2026 23:27
@TMHSDigital

Copy link
Copy Markdown
Owner Author

Correction to the description above: I said the example report's latency line "differs on every run". It does not. The mock simulates latency from its seed, so a rerun of the recorded command reproduces every line of the report, latency included, and the hand edits in this PR are byte-identical to what the code now prints. The site build now checks every line (only the date and path separators are normalized); see the follow-up PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant